home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 January / macformat-020.iso / Shareware City / Graphics / SuperSlide / Read Me < prev    next >
Encoding:
Text File  |  1994-08-06  |  7.4 KB  |  163 lines  |  [TEXT/ttxt]

  1.                                 SuperSlide! 1.0.0
  2.                                       
  3.  
  4. 1.- Introduction.
  5.  
  6. SuperSlide! is a combination of a native PowerPC program and a stack of HyperCard 2.1, wich can display PICT, JPEG, JFIF, GIF, PIC (CLP) and PCX files in "slide shows" controlled by AppleEvents.
  7.  
  8. The program has also options for simple "slide shows", but the principal versatility is obtained using a controlling program such as the enclosed stack "Control" of HyperCard 2.1, wich sends the Apple Event "doscript" with instructions to SuperSlide!.
  9.  
  10. 2.- Files.
  11.  
  12. The package contains the following files:
  13.  
  14. • Read Me              This file.
  15. • SuperSlide!         The program.
  16. • Control               Stack of HyperCard, contains buttons to activate SuperSlide!.
  17. • background          Pict file, used with 12-slides button of Control.
  18. • open test             Script Editor document, open test.gif
  19. • test.gif                Small test GIF file.
  20. • "PICT JDRs"         AutoTyper, changes the file creator of PICT files to SuperSlide! signature.
  21. • "???? JDRs"         AutoTyper, changes the file creator of other files to SuperSlide! signature.
  22.  
  23.  
  24. 3.- Using the program.
  25.  
  26. This program has an unusual interface, it exists only one window using all the area of the principal monitor including the menubar, which at the start of the program is hidden, all of the controls are in a pop-up menu wich is activated with a drag in any point of the window.
  27.  
  28. The pop-up menu have this commands:
  29.  
  30. About...                 Display the about box.
  31. Open...                   Open the file.
  32. Hide MenuBar       Hide or Show the menubar
  33. Slide Show           Hierarchic menu, has the following submenu:
  34.    Directory...          Select a directory for the slide show.
  35.    First File...          Select the first file for the slide show.
  36.    Delay                    Hierarchic menu, have 0 to 60 seconds and Click, with this last option, the program waits for a click, use shift-click or option-click for escape.
  37. Size                     Hierarchic menu, have the following submenu:
  38.    Normal
  39.    Half
  40.    Double
  41.    Adjust to screen If the rectangle of the picture is greater than the screen, adjust the display to the size of the screen.                         
  42.    Fit to screen    Use the size of the screen as the size of the picture.
  43. Display               Hierarchic menu, have the following submenu:
  44.    Palette                Hierarchic menu, have the following submenu:
  45.       System               Use the System palette
  46.       systemMethod    This tree option use a custom palette.
  47.       popularMethod
  48.       medianMethod
  49.       Copy CTable        This option is for use of CLP files, see below.
  50.    CopyBits             Hierarchic menu, have the following submenu:
  51.       srcCopy                 Display the picture normal.
  52.       dither+srcCopy      Use dither in the display. 
  53.    Background          Hierarchic menu, select other color for the background.
  54. Caps Lock Pause   Use the key Caps Lock for a pause of the program.
  55. Quit                      Finish the program, also use <Cmd .> at any time.
  56.  
  57. 4.- Types of files.
  58.  
  59. The program can accept Mac files of type 'PICT', 'JPEG' and  'JFIF', but also can accept files of type 'TEXT' or '????' and tries automatically to identify the files of type JFIF, GIF, PIC (CLP) and PCX.
  60.  
  61. For display of JPEG and JFIF files QuickTime is needed.
  62.  
  63. The program can also accept (and resolve) alias of files, and accepts drag and drop of files or one folder (only one for this version).
  64.  
  65. If you use one of the enclosed AutoTypers, you can also double click a file for executing the program.
  66.  
  67. The type PIC have a variant CLP without a palette, because of this, it is necessary to  display first a PIC file with the correct palette, then use the option Copy CTable, and then display the CLP files. By the way, there are other types of files named PIC (and CLP) unrelated to this type of file.
  68.  
  69. Not all of the PCX variants are supported.
  70.  
  71. 5.- Apple Events.
  72.  
  73. Read the following sections if you are interested in writing a HyperTalk script for controlling the program.
  74.  
  75. The program accepts the core events and the "doscript" event, because of this, it is posible to use the command "send program" of HyperTalk to control SuperSlide!.
  76. The enclosed stack Control has a few buttons with scripts of HyperTalk  controlling SuperSlide!.
  77.  
  78. Also SuperSlide! can send a "doscript" event back to HyperCard, with this option is posible to obtain a little interactivity in the slide shows.
  79.  
  80. If the "doscript" event has a "#" as the first character of the string, then it is a command of SuperSlide!, otherwise it is used as a string to display in the current position, font, size, face and mode in the window.
  81.  
  82. 6.- Commands.
  83.  
  84. The commands of SuperSlide! are:
  85. #O <name>                                  Open the file <name>
  86.  
  87. #M <menu> <submenu>                Activate the equivalent of the pop-up menu,
  88. use the following codes:
  89. <menu>  <submenu>
  90. 150       1                      About...
  91. 150       3                      Open...
  92. 150       4                      Hide MenuBar
  93. 150       8                      Caps Lock Pause
  94. 150     10                      Quit
  95. 151       1                      Directory...
  96. 151       2                      First File...
  97. 152       1 - 9                Delay
  98. 153       1 - 5                Size, use negative numbers if the custom rectangle is the target.
  99. 155       1  - 6               Palette
  100. 156       1                      CopyBits srcCopy
  101. 156       2                      CopyBits dither+srcCopy
  102. 157       1 - 5                Background
  103.  
  104. #R <top> <left> <right> <bottom>    Set a custom rectangle, use this rectangle to display the next pictures. Reset the size with a menu command.
  105.  
  106. #C <red> <green> <blue>             Set the foreground color
  107.  
  108. #B <red> <green> <blue>             Set the background color
  109.  
  110. #H <string>                                Set the "hand" cursor, wait for a click and return <string> <point-click>  as a "doscript" event back to HyperCard.
  111.  
  112. #J <opt>                                     Set debug memory info, opt = 1 for debug.
  113.  
  114. #E  <opt>                                    Erase window before display (default = 1).
  115.  
  116. #P <opt>                                     Push/Pop image, use the following options:
  117. <opt>
  118. 0              Push the current image.
  119. 1              Pop the save image, dispose the save image.
  120. 2              Pop the save image, retain the save image.
  121. 3              Only dispose the save image.
  122.  
  123. #F <Name> <Size> <Face> <Mode>  Font, example: "#F 'Geneva' 9 0 0".
  124.  
  125. #T <x> <y>                                  move To <x> <y>, change the position for display text.
  126.  
  127. #U <opt>                                     Update, use the following options:
  128. <opt>
  129. 0              Invalidate main window.
  130. 1              Erase and invalidate main window.
  131. 2              Erase and validate main window.
  132. 3              Erase custom rectangle.
  133.  
  134. #W <opt>                                     Window, use the following options:
  135. <opt>
  136. 0              Restore window to size of main monitor.
  137. 1              Adjust window to size of custom rectangle.
  138.  
  139. 7.- Acknowledgments.
  140.  
  141. This program uses routines modified of the source of GL Viewer 1.1.1 by Martin Fong to display the MS-DOS files (GIF, PIC, PCX). GL Viewer is a modification of GL View 1.0 copyright (c) 1991 by Patrick J. Naughton, wich is a port of xgrasp.
  142. The stack Control uses the GetDir 2.2 XFCN, © Frédéric Rinaldi, 1989...1993.
  143.  
  144. This software is free for non-commercial use.
  145.  
  146. Javier Díaz Reinoso
  147. JSoft, 1994
  148. P.O.Box 1712-574
  149. Quito, Ecuador
  150. xdiaz@pi.pro.ec
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.                              
  161.  
  162.  
  163.